home *** CD-ROM | disk | FTP | other *** search
/ Hot Metal Pro 4.0 / Hot Metal Pro 4.0.iso / HMPRO4 / cgi.z / readme.txt < prev    next >
Encoding:
Text File  |  1997-06-12  |  10.0 KB  |  193 lines
  1. # Countdown Script for the WWW
  2. # Written by Matt Wright
  3. # Modifications by SoftQuad for inclusion in HoTMetaL 4.0 
  4. #   Made: 06/12/97
  5. #   Indicated by **(SQ)
  6. # Version 1.21
  7. # Created on: 9/1/95    Last Modified on: 10/8/95
  8. # I can be reached at:          mattw@misha.net
  9. # Scripts found at:             http://www.worldwidemart.com/scripts/
  10. ##############################################################################
  11. # If you run into any problems while trying to configure this scripts, help  #
  12. # is available.  The steps you should take to get the fastest results, are:  #
  13. #       1) Read this file thoroughly                         #
  14. #       2) Consult the Matt's Script Archive Frequently Asked Questions:     #
  15. #               http://www.worldwidemart.com/scripts/faq/             #
  16. #       3) If you are still having difficulty installing this script, send   #
  17. #          e-mail to: scripts-help@tahoenet.com                     #
  18. #          Include any error messages you are receiving and as much detail   #
  19. #          as you can so we can spot your problem.  Also include the variable#
  20. #          configuration block that is located at the top of the script.     #
  21. #                                         #
  22. # Hopefully we will be able to help you solve your problems.  Thank you.     #
  23. ##############################################################################
  24.  
  25. The Countdown script is a somewhat simple script, which takes the time you give 
  26. it and tells you the number of years, months, days, hours, minutes, seconds 
  27. until that event will occur.  More details on how to use this script are below.
  28.  
  29. WHAT THIS SCRIPT CONTAINS:
  30.         This script comes with 3 different files:
  31.                 1) countdwn.pl  - The Perl script which does the calculation 
  32.                                   of the time until an event will occur.
  33.                 2) readme.txt   - The file that does all the explaining.
  34.                 3) countdwn.htm - An example of ways to incorporate 
  35.                                   countdwn.pl and use it properly.
  36.  
  37.  
  38. You will have to do some minimal configuration of the countdwn.pl file:
  39.  
  40. COUNTDWN.PL -
  41.         The countdwn.pl file is the main file in this package.  This file 
  42. needs to be placed in the server's cgi-bin or have its name changed to 
  43. countdown.cgi.  Keep in mind the latter option only works should your server 
  44. be set up to treat all .cgi files in a script manner.  If you are not sure 
  45. about this, consult your system administrator.  Inside the countdwn.pl file 
  46. you can do one of two things:
  47.  
  48.         1) If you plan to just call the same date every time from this 
  49.            script, change the @from_date variable to the date you want it 
  50.            to countdown to.  This can include all the way up to seconds.  The
  51.            format for this should look like:
  52.  
  53.               @from_date = (yyyy,mm,dd,hh,mm,ss);
  54.  
  55.                 Where:
  56.                         yyyy - The Year in Four Digits.
  57.                         mm   - The first mm is the month number from 1-12.
  58.                         dd   - The Day of the month.  Values range from 1-31.
  59.                         hh   - The hour of the day.  Values range from 0-23.
  60.                         mm   - The second mm is the minute of the hour from 
  61.                                0-59.
  62.                         ss   - The ss stands for seconds and the value can 
  63.                                range from 0-59.
  64.  
  65.         2) If you plan to call different dates via a html page, you don't have 
  66.            to worry about setting any variables inside the script.
  67.  
  68. At any rate you will probably want to edit the subroutines &html_header and 
  69. &html_trailer, to customize it for your wants/needs.
  70.  
  71. ------------------------------------------------------------------------------
  72.  
  73. HOW DO I IMPLEMENT THIS SCRIPT?!
  74.  
  75. 1) If you have defined the @from_date in the countdwn.pl file and you wish to 
  76.    only call the same value each time, you can simply do the following:
  77.  
  78.    <a href="http://your.server/cgi-bin/countdwn.pl">Countdown to ...</a>
  79.  
  80.    When the user clicks on this they will be taken to a cgi generated page that
  81.    tells them the countdown status.
  82.  
  83. 2) Should you want to use this counter for various countdown you can also call 
  84.    a specific date directly from the link, in the same fashion as you would 
  85.    have defined @from_date. (See Above for info on how to define @from_date.)
  86.    Let's say I want to countdown to my birthday in 1996.  My birthday is 
  87.    April 15: 4/15, so I would do something like:
  88.  
  89.     <a href="http://my.server/cgi-bin/countdwn.pl?1996,4,15,0,0,0">Countdown 
  90.     to my birthday!</a>
  91.  
  92. 3)  Allow users to countdown to their own dates!  If you want to do this you 
  93.     would use the following syntax:
  94.  
  95.     <FORM METHOD=GET ACTION="http://your.server/cgi-bin/countdwn.pl">
  96.     <INPUT TYPE=TEXT NAME=""><P>
  97.     <INPUT TYPE=SUBMIT>
  98.     </FORM>
  99.  
  100.     Then when the user types in his/her query the program will generate an 
  101.     automatic response.  Make sure to let your users and yourself know that 
  102.     the format for the query must match the exact same definition as @from_date. 
  103.     (See Above for info on how to define @form_date.)
  104. -------------------------------------------------------------------------------
  105.  
  106. ADVANCED FEATURES OF COUNTDOWN!
  107.  
  108. In Some situations it may be impractical to count out to seconds.  Or maybe if 
  109. you are counting down to something closer than year, you will want to leave 
  110. out the year portion of the countdown since it is only going to be 0 all the 
  111. tie anyways.  Or maybe the same goes for month, day, etc...  Countdown has a 
  112. built in feature to allow you to do this.  Instead of defining all categories 
  113. in @from_date you can do the following:
  114.  
  115. 1) Say I want to leave out the year in the countdown to my birthday (From the 
  116.    example above.) I could also do this:
  117.  
  118.     <a href="http://my.server/cgi-bin/countdwn.pl?XX,4,15,0,0,0">Countdown
  119.     to my birthday!</a>
  120.  
  121.    When the user gets the returned html document, the # of years will not be 
  122.    shown.  You can put an 'XX' in any of the fields (year, month, day, hour, 
  123.    minute, second) and it will disregard that amount of time.
  124.  
  125. 2) You can also define the same way inside of the countdwn.pl.  If you are 
  126.    using a standard countdown, meaning that you see no need for  multiple 
  127.    countdowns, you can set your @from_date in your Perl script to reflect this 
  128.    (This concept is also mentioned above).  You can substitute in 'XX' for any 
  129.    amount of time you don't want. (Be it year, month, day, hour, minute, or
  130.    second)
  131.  
  132. -------------------------------------------------------------------------------
  133.  
  134. OTHER USEFUL THINGS COUNTDOWN DOES BEHIND THE SCENES:
  135.  
  136. 1) Will not return a negative value.  Often times you would see a negative 
  137.    number of hours.  Instead, when countdown comes across a negative value, it 
  138.    simply adds the correct number (12 for months, appropriate number for days, 
  139.    24 for hours, 60 for minutes and seconds).  It then subtracts one from the
  140.    next highest category so that your time comes out perfect, and all in 
  141.    positive time.  Years will appear in negative time, since if you are that 
  142.    far behind, you're messed up!  :)
  143.  
  144. 2) Calculates number of days in each month,and recognizes leap years to!
  145.  
  146. 3) Notices the difference between 1 hour and 2 hours.  So that you get proper 
  147.    English instead of 1 hours. Works the same for other units.
  148.  
  149. ------------------------------------------------------------------------------
  150.  
  151. HISTORY:
  152. Version 1.0             9/1  - Script Created.
  153. Version 1.1             9/3  - Improved the script based on suggestions by 
  154.                                Scott Lipcon:
  155.                                - Added an extra 0 to the seconds and minutes 
  156.                                  if the times were less than ten, so the 
  157.                                  clock came out looking like 5:00:00 instead
  158.                                  of 5:0:0
  159.                                - Changed the '.' in the time to a ':' between 
  160.                                  seconds and minutes so that clock looks 
  161.                                  like: '5:00:00' instead of '5:00.00'
  162.                                - Corrected the leap year system, so that it 
  163.                                  will get leap years correct.
  164.                                - Commented the file better.
  165.                              - Edited the README file slightly.
  166. Version 1.2             9/8  - Several bugs fixed based on the obersvations by 
  167.                                Elton Taupin.
  168.                                - Bug fixed that caused current date to be 
  169.                                  screwed up when the time was < 10 minutes.  
  170.                                  The problem had something to do with a 
  171.                                  misplaced colon.
  172.                                - Fixed a bug in the countdown portion of the 
  173.                                  script, which caused an extra date to be 
  174.                                  displayed on the countdown on certain 
  175.                                  instances.  It was a case of subtracting 
  176.                                  from $month, instead of $real_month.
  177. Version 1.21                   - Slight bug with 1 too many months fixed.
  178. -----------------------------------------------------------------------------
  179.  
  180. This script is provided to be useful and comes with no warranty, express or 
  181. implied.  I cannot guarantee the safety of it, yet I see no urgent problems.  
  182. I only did my best.
  183.  
  184. If you end up using this script, I would like to know where it is 
  185. implemented.  If you let me know I can add you to my list of other sites using 
  186. this script, or if you wish not to be added, I will keep your site private.  I 
  187. just want to know.  You can register this script at:
  188.         http://worldwidemart.com/scripts/implement.html
  189.  
  190. This script is provided for free, so I hope you enjoy it!
  191. ______________________________________________________________________________
  192. Matt Wright (mattw@misha.net) - http://www.worldwidemart.com/scripts/
  193.